home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL / glgetpixelmap.z / glgetpixelmap
Encoding:
Text File  |  2002-10-03  |  13.5 KB  |  133 lines

  1.  
  2.  
  3.  
  4. ggggllllGGGGeeeettttPPPPiiiixxxxeeeellllMMMMaaaapppp((((3333GGGG))))              OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee              ggggllllGGGGeeeettttPPPPiiiixxxxeeeellllMMMMaaaapppp((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllGGGGeeeettttPPPPiiiixxxxeeeellllMMMMaaaappppffffvvvv,,,, ggggllllGGGGeeeettttPPPPiiiixxxxeeeellllMMMMaaaappppuuuuiiiivvvv,,,, ggggllllGGGGeeeettttPPPPiiiixxxxeeeellllMMMMaaaappppuuuussssvvvv - return the
  10.      specified pixel map
  11.  
  12.  
  13. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  14.      void ggggllllGGGGeeeettttPPPPiiiixxxxeeeellllMMMMaaaappppffffvvvv( GLenum _m_a_p,
  15.                            GLfloat *_v_a_l_u_e_s )
  16.      void ggggllllGGGGeeeettttPPPPiiiixxxxeeeellllMMMMaaaappppuuuuiiiivvvv( GLenum _m_a_p,
  17.                             GLuint *_v_a_l_u_e_s )
  18.      void ggggllllGGGGeeeettttPPPPiiiixxxxeeeellllMMMMaaaappppuuuussssvvvv( GLenum _m_a_p,
  19.                             GLushort *_v_a_l_u_e_s )
  20.  
  21.  
  22. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  23.      _m_a_p     Specifies the name of the pixel map to return.  Accepted values
  24.              are GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____IIII, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____SSSS____TTTTOOOO____SSSS,
  25.              GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____RRRR, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____GGGG, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____BBBB,
  26.              GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____AAAA, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____RRRR____TTTTOOOO____RRRR, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____GGGG____TTTTOOOO____GGGG,
  27.              GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____BBBB____TTTTOOOO____BBBB, and GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____AAAA____TTTTOOOO____AAAA.
  28.  
  29.      _v_a_l_u_e_s  Returns the pixel map contents.
  30.  
  31. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  32.      See the ggggllllPPPPiiiixxxxeeeellllMMMMaaaapppp reference page for a description of the acceptable
  33.      values for the _m_a_p parameter.  ggggllllGGGGeeeettttPPPPiiiixxxxeeeellllMMMMaaaapppp returns in _v_a_l_u_e_s the
  34.      contents of the pixel map specified in _m_a_p.  Pixel maps are used during
  35.      the execution of ggggllllRRRReeeeaaaaddddPPPPiiiixxxxeeeellllssss, ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss, ggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD,
  36.      ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD,
  37.      ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD,
  38.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD, ggggllllCCCCoooolllloooorrrrTTTTaaaabbbblllleeee, ggggllllCCCCoooolllloooorrrrSSSSuuuubbbbTTTTaaaabbbblllleeee,
  39.      ggggllllCCCCooooppppyyyyCCCCoooolllloooorrrrTTTTaaaabbbblllleeee, ggggllllCCCCooooppppyyyyCCCCoooolllloooorrrrSSSSuuuubbbbTTTTaaaabbbblllleeee, ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnFFFFiiiilllltttteeeerrrr1111DDDD,
  40.      ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnFFFFiiiilllltttteeeerrrr2222DDDD, ggggllllSSSSeeeeppppaaaarrrraaaabbbblllleeeeFFFFiiiilllltttteeeerrrr2222DDDD, ggggllllGGGGeeeettttHHHHiiiissssttttooooggggrrrraaaammmm, ggggllllGGGGeeeettttMMMMiiiinnnnmmmmaaaaxxxx,
  41.      and ggggllllGGGGeeeettttTTTTeeeexxxxIIIImmmmaaaaggggeeee to map color indices, stencil indices, color
  42.      components, and depth components to other values.
  43.  
  44.      Unsigned integer values, if requested, are linearly mapped from the
  45.      internal fixed or floating-point representation such that 1.0 maps to the
  46.      largest representable integer value, and 0.0 maps to 0.  Return unsigned
  47.      integer values are undefined if the map value was not in the range [0,1].
  48.  
  49.      To determine the required size of _m_a_p, call ggggllllGGGGeeeetttt with the appropriate
  50.      symbolic constant.
  51.  
  52. NNNNOOOOTTTTEEEESSSS
  53.      If an error is generated, no change is made to the contents of _v_a_l_u_e_s.
  54.  
  55. EEEERRRRRRRROOOORRRRSSSS
  56.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _m_a_p is not an accepted value.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllGGGGeeeettttPPPPiiiixxxxeeeellllMMMMaaaapppp((((3333GGGG))))              OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee              ggggllllGGGGeeeettttPPPPiiiixxxxeeeellllMMMMaaaapppp((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllGGGGeeeettttPPPPiiiixxxxeeeellllMMMMaaaapppp is executed between
  75.      the execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ggggllllEEEEnnnndddd.
  76.  
  77. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  78.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____IIII____SSSSIIIIZZZZEEEE
  79.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____SSSS____TTTTOOOO____SSSS____SSSSIIIIZZZZEEEE
  80.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____RRRR____SSSSIIIIZZZZEEEE
  81.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____GGGG____SSSSIIIIZZZZEEEE
  82.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____BBBB____SSSSIIIIZZZZEEEE
  83.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____AAAA____SSSSIIIIZZZZEEEE
  84.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____RRRR____TTTTOOOO____RRRR____SSSSIIIIZZZZEEEE
  85.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____GGGG____TTTTOOOO____GGGG____SSSSIIIIZZZZEEEE
  86.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____BBBB____TTTTOOOO____BBBB____SSSSIIIIZZZZEEEE
  87.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____AAAA____TTTTOOOO____AAAA____SSSSIIIIZZZZEEEE
  88.      ggggllllGGGGeeeetttt with argument GGGGLLLL____MMMMAAAAXXXX____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____TTTTAAAABBBBLLLLEEEE
  89.  
  90.  
  91. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  92.      ggggllllCCCCoooolllloooorrrrSSSSuuuubbbbTTTTaaaabbbblllleeee, ggggllllCCCCoooolllloooorrrrTTTTaaaabbbblllleeee, ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnFFFFiiiilllltttteeeerrrr1111DDDD,
  93.      ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnFFFFiiiilllltttteeeerrrr2222DDDD, ggggllllCCCCooooppppyyyyCCCCoooolllloooorrrrSSSSuuuubbbbTTTTaaaabbbblllleeee, ggggllllCCCCooooppppyyyyCCCCoooolllloooorrrrTTTTaaaabbbblllleeee,
  94.      ggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss, ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD,
  95.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD, ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss, ggggllllGGGGeeeettttHHHHiiiissssttttooooggggrrrraaaammmm,
  96.      ggggllllGGGGeeeettttMMMMiiiinnnnmmmmaaaaxxxx, ggggllllGGGGeeeettttTTTTeeeexxxxIIIImmmmaaaaggggeeee, ggggllllPPPPiiiixxxxeeeellllMMMMaaaapppp, ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr, ggggllllRRRReeeeaaaaddddPPPPiiiixxxxeeeellllssss,
  97.      ggggllllSSSSeeeeppppaaaarrrraaaabbbblllleeeeFFFFiiiilllltttteeeerrrr2222DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD
  98.      ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD,
  99.      ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.